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CA Technologies Product References 


This document references the following CA Technologies products: 
m  AllFusion? Gen 

m CAGen 

m COOL: Gen 

m Advantage™ Gen 


m  Unicenter? Software Delivery 


Contact CA Technologies 


Contact CA Support 


For your convenience, CA Technologies provides one site where you can access the 
information that you need for your Home Office, Small Business, and Enterprise CA 
Technologies products. At http://ca.com/support, you can access the following 
resources: 


m Online and telephone contact information for technical assistance and customer 
services 


m Information about user communities and forums 
m Product and documentation downloads 
m CA Support policies and guidelines 


m Other helpful resources appropriate for your product 
Providing Feedback About Product Documentation 


If you have comments or questions about CA Technologies product documentation, you 


can send a message to techpubs@ca.com. 


To provide feedback about CA Technologies product documentation, complete our 
short customer survey which is available on the CA Support website at 


http://ca.com/docs. 


Documentation Changes 


The following documentation updates have been made since the last release of this 
documentation: 


Installing CA Gen on NonStop (see page 57)— Updated this topic to include the 
SQL/MX database information. 


Installing Support for SQL/MX (see page 64)—Added this topic to include the 
SQL/MX database information. 
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Chapter 1: CA Gen Licensing 


Trial Period 


Licenses 


CA Gen does not require a valid license file to install components. You can install any 
component and can use it for a 30-day trial period. Only the licensed components 
continue to work after the 30-day trial period ends. 


The 30-day trial period does not apply to features for which you already have licenses, 
even if the license expired. If existing licenses for releases before Release 8.5 expired 
before installing CA Gen Release 8.5, the component that is associated with that license 
fail with an invalid license message. Since the transition to the new 30-day trial feature 
occurs only once, future releases of CA Gen will not issue the invalid license behavior. 


To ensure uninterrupted use of CA Gen, get updated license keys for expired 
components before installing CA Gen Release 8.5. 


The licensing system on Windows, UNIX, and Linux platforms is similar. After the trial 
period ends, the license file defines the components that continue to execute and the 
generation options available. 


The license directory contains the licensing software. When the license directory also 
contains a file that is named ca.olf, the new licenses are merged with existing licenses. 


Windows setup installs the licensing software for a new installation or updates the 
software for an existing installation. During a new installation on a Windows-based 
system, installation software creates the licensing folder C:\Program 
Files\CA\SharedComponents\CA_LIC. For a Windows upgrade, the license folder is 
CACA LIC. 


For a new UNIX or a Linux system installation, the installation software creates this 
licensing folder: /opt/CA/SharedComponents/ca lic. If there was a previous installation 
of the licensing software in /ca lic or /opt/CA/ca lic, the installation moves the license 
file to /opt/CA/SharedComponents/ca lic and replaces the old directory with a symbolic 
link to /opt/CA/SharedComponents/ca lic. It creates the symbolic link to maintain 
support for legacy CA-licensed programs. 


The UNIX or Linux installer creates an empty ca.olf. If it does not exist so you can merge 
licenses. 
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ALP Key Certificates 


ALP Key Certificates 


When you receive the CA Gen software with one or more ALP (Automated Licensing 
Program) key certificates, one for each CA Gen component for which you have a license. 
The instructions on these certificates are as follows: 


m  Editthe license file using a text editor 

m  Addthe license information for each component 

m Obtain the license file from the CA Technical Support Web site 

The license directory contains the licensing software and a file that is named ca.olf, the 


new licenses are merged with existing licenses. The UNIX or Linux installer creates an 
empty ca.olf. If it does not exist, merge the license. 


Perform the following steps to log in to Technical Support Site. 


Follow these steps: 

1. Logonto the Technical Support Web site. 

2. Under Downloads, select the License keys link. 

3. When it displays the Total License Care (TLC) page, ensure that your site ID is 


correct and click Install. 


Note: The UNIX or Linux setup program automatically updates the licensing software, if 
necessary, as the first step in installing CA Gen. 


10 Distributed Systems Installation Guide 


Chapter 2: Upgrading to a New Release 


When you move to a new CA Gen release, consider how to make the move with 
minimum impact on applications in production or under development. 


Considerations When Upgrading CA Gen Components 


Schema Release Levels 


The underlying structure of stored model information consists of objects, properties, 
and associations. The structure adhere to a rigorous set of rules that define: 


m Objects that are allowed or that you can create 
m Properties that are allowed or are required to describe those objects 


m Associations that are allowed or are required to describe how those objects relate 
to one another 


The objects, properties, and associations; and rules that govern how they interrelate, 
are named the schema release or metamodel, for a CA Gen software release. A schema 
of an encyclopedia is the highest model schema the Encyclopedia supports. 


The DMAX table stores values for properties that apply to the entire encyclopedia, such 
as the encyclopedia name and ID. The highest schema release level on the DMAX table 
identifies the current version of the metamodel an Encyclopedia supports. 


The DMDL tables stores values for properties that apply to an entire model, such as the 
model name. The MODEL RELEASE in the DMDL table indicates the release level for 
each model. 


The following table lists releases over the past several years, the schema release level 
for each release, and the introduction and retirement dates. 


Release Schema Introduced Retired 

CA Gen Release 8.5 9.2.A6 May 2013 

CA Gen 8 9.2.46 May 2010 

AllFusion Gen 7.6 9.1.A5 November 2006 April 30, 2012 
AllFusion Gen 7.5 9.1.A5 February 2006 December 2008 
AllFusion Gen 7 9.1.A5 December 2004 December 2007 
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Considerations When Upgrading CA Gen Components 


Encyclopedias 


Release Schema Introduced Retired 
AllFusion Gen 6.5 9.0.A2 October 2002 June 2007 
COOL:Gen 6.0 9.0.A2 September 2000 June 2004 
COOL:Gen 5.1 8.0.A3 September 1999 September 2002 
COOL:Gen 5.0 8.0.A3 September 1998 March 2001 
COOL:Gen 4.1A 7.0.48 August 1997 September 2000 
Composer 4 7.0.A8 November 1996 March 1999 


Current schema is the schema for the current release of CA Gen. Prior schema and 
second prior schema refer to schemas supported in the most recent releases of 
AllFusion Gen. 


Note: For the schema designation for Current Schema, Prior Schema, and Second Prior 
Schema, see the Release Notes or the Toolset Help. 


The same rules apply to each release according to the schema supported in the release. 
A statement about support for a particular schema applies to all releases that support 
the schema. 


CA Gen Host Encyclopedia and Client-Server Encyclopedia support current and prior 
schema models. Prior schema models cannot use the new features of the current 
schema. However, prior schema models can use other, non-schema that is related, 
features of the new release. 


CA Gen supports transition models in the second prior schema. You can upload and 
convert them to the current schema release level or you can delete them. 


For the models at a schema level older than the second prior schema, you convert them 
to the second prior schema or prior schema using an encyclopedia release that precedes 
CA Gen Release 8.5 before converting them to the current schema. If a model is not in 
the current schema, the prior schema, or the second prior schema after the upgrade 
completes, the only permitted encyclopedia operation on the model is to delete it. 


Important! Do not upgrade your encyclopedia before completing the model conversions 
to a schema that is at least the second prior schema for this release. 
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Considerations When Upgrading CA Gen Components 


Some constraints apply to encyclopedia functions that use multiple models. For 
example, when using version control, the following table identifies supported and 
unsupported combinations. 


Source Model Destination Model Supported 
Current Schema Current Schema Yes 
Prior Schema Current Schema Yes 
Current Schema Prior Schema No 
Prior Schema Prior Schema Yes 


Client Server Encyclopedia Component Compatibility 


The Client-Server Encyclopedia Checkout client is at the same release as the 
Workstation Toolset. There is no Workstation Toolset constraint for other clients. Since 
the clients are frequently updated after updating the Workstation Toolset, be aware of 
the following compatibilities between clients and servers: 


CA Gen Release 8.5 Client-Server Encyclopedia servers support CA Gen Release 8 
and AllFusion Gen 7x clients. Not all new features of the CA Gen Release 8.5 
Client-Server Encyclopedia servers are available when using the AllFusion Gen 7x 
and CA Gen Release 8 clients. 


COOL:Gen 6.0 and Advantage Gen 6.5 Client-Server Encyclopedia clients are 
compatible with Advantage Gen 6.5 servers and AllFusion Gen 7 servers. Not all 
new features in the later release servers are available to these clients. 


The following communication considerations are: 


CA Gen supports seamless connections between all combinations of current 
schema and prior schema encyclopedia server releases. A seamless connection 
implies that Client-Server Encyclopedia servers from different releases can interact 
entirely through the Client-Server Encyclopedia client interfaces. Both 
encyclopedias must support the models that are involved in any seamless 
operation. 


CA Gen supports non-seamless functions between all combinations of supported 
Client-Server Encyclopedia servers. A non-seamless connection implies that 
Client-Server Encyclopedia servers from different releases can interact through a 
command-line interface. Both encyclopedias must support the schemas of models 
that are involved in any non-seamless operation. 
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Plan for an Upgrade 


Workstation Toolsets 


A Workstation Toolset supports a single schema release level, the current schema, and 
cannot open models in any other schema. You cannot check in any models or subsets 
checked out in a different schema. 


Continuing with CA Gen Release 8.5, CA Gen supports installing different releases of the 
Toolset on one machine with different levels of support for some components. 


More information: 


Required Windows Privileges (see page 65) 


Generators 


The generators delivered with each release of CA Gen produce code targeted for the 
runtime in the same release. Generators delivered with the Toolset operate only on 
current schema models because the Toolset only supports current schema models. You 
can use generators delivered with an encyclopedia with current schema models and 
prior schema models. The generated source code is always for the current runtime. 


Upgrading to a new release encyclopedia and toolset require eventually upgrading 
generated applications to the current release of the runtime. 


Note: For more information about regenerate, recompile, or relink when upgrading to a 
new release, see the Release Notes. 


Plan for an Upgrade 


Plan the upgrade to a new release of CA Gen carefully. Many factors in your 
organization determine the level and extent of the required tasks and planning. Your 
upgrade plans reflect how your organization uses CA Gen. 
Each time that you upgrade from one release to the next: 
m Make sure that you understand the effect of the new release 
m Construct an upgrade plan for your organization that includes: 

-  Astrategy for moving model development to the new software 

-  Aplan for ongoing support of generated applications 


-  Aplan for rolling out the new release to the organization 
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Plan for an Upgrade 


Understand the Effect of the New Release 


Before you upgrade to a new release, it is important to understand the differences 
between the release you have been using and the new release. Differences that you 
encounter include: 


m New features and functionality provide opportunities to enhance the applications 
you are developing or maintaining, and to make the development process 
smoother. 


m Technical requirements change as other environments and products change. 
m A new schema release for CA Gen requires model conversions. 


m Code generator changes make differences in application performance or 
interactions. 


Understand the New Features 


To plan the new release rollout, upgrade managers familiarize themselves with the new 
features of the release, functionality, and technical requirements in the Release Notes. 


Note: For more information about regenerate, recompile, or relink when migrating to 
the current release, see the Release Notes. 


If you skipped an upgrade to one or more releases, review the Release Notes for each 
skipped release, and the Release Notes for current release. Review the z/OS Installation 
Guide, for skipped releases, especially when upgrading from a release that CA Gen no 
longer supports. 


Phased Implementation 


You can phase in the upgrades for any release. It is not necessary to upgrade all CA Gen 
products simultaneously. When you phase in the upgrades, the following general 
guidelines apply: 


m Upgrade the encyclopedia first. Check in all models before upgrading the 
encyclopedia, including models and subsets checked out to Workstation Toolsets 
and to other encyclopedias. After the upgrade completes, check out the models you 
need. 


m When the schema level changes, you convert existing models on the encyclopedia 
before downloading them to the new Workstation Toolset. If the encyclopedia 
includes models in schema levels that are not supported in the new release, convert 
or delete these models. 
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Plan for an Upgrade 


m A Workstation Toolset only supports models at a single schema level. 


m The Implementation Toolset must be at the same or a newer release as the Build 
Tool, primarily because of the runtime routines the generated code expects. 


Construct an Upgrade Plan for Your Organization 
After you understand the effect of the new release, the next step is to build an upgrade 
plan that consists of these major components: 
m A strategy for moving models to the new release 
m A strategy for maintaining application systems with the new release 


m A plan for rolling out the new release to the organization 
Develop a Model Upgrade Strategy 
The model upgrade strategy addresses how to move existing models to the new release. 
Upgrading the models involves these steps: 
1. Populating the encyclopedia 
2. Converting the model to the new schema 


You address populating the encyclopedia for all models when you install the 
encyclopedia software for the new release. 


When you use the new Toolset and edit the model are not at the same schema level, 
you convert the model before you can download it to the new Workstation Toolset. You 
use an encyclopedia to convert prior schema and second prior schema models to the 
current schema release for support on a current schema workstation. After converting 
the model, all Workstation Toolsets that use the model must be at the current schema 
release. 


More information: 


Considerations When Upgrading CA Gen Components (see page 11) 


How to Determine Your Model Upgrade Strategy 


To move existing models to a new release, determine your model upgrade strategy by 
performing the following tasks: 


Follow these steps: 
1. Order and install the encyclopedia and workstation software. 


2. Establish a test environment for the upgrade project after you install the 
encyclopedia software. 
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Plan for an Upgrade 


Identify how to populate the encyclopedias. For options, see Considerations When 
Upgrading Your Encyclopedia (see page 17). 


Create a model inventory. 


Identify the models to retain with the new release. For each model, record the 
following information: 


m Ownership 


m Contents, for example, where in the life cycle the model is, if the model is used 
for construction, and so on 


m Size, for example, number of objects 


m  Usage,for example, is the model in development; does it represent a 
generated system or is it the source of objects for other models 


m Location of the model, for example, does the model returned from a Client 
Server Encyclopedia (CSE) to a Host Encyclopedia or to another Client-Server 
Encyclopedia 


Consider development plans. 


The upgrade plan must consider development and implementation plans of models 
in development. When possible, schedule conversion when there is minimal 
implementation and construction activities to reduce disruption to development 
work of the team. 


Test the upgrade strategy. 
Select a model to test the upgrade strategy. 


Test the encyclopedia population method that you are using. Estimate the timing 
and space requirements for the actual conversion. 


Define a fallback or contingency plan that lists the steps that are required if severe 
problems develop during the upgrade. 


Determine the sequence of model conversions and note special requirements or 
milestones for development projects. 


How to Upgrade a Client Server Encyclopedia 


After completing the upgrade plan for your organization, you are ready to do the Client 
Server Encyclopedia (CSE) upgrade. 


Follow these steps: 


1. 


Before installing the new release, use the currently installed Client-Server 
Encyclopedia release and verify that there are no checked out models or subsets 
and that all models are in a schema the new release supports. Take corrective 
action to make the encyclopedia ready to upgrade before removing the currently 
installed release. 


Shut down the CSE. 
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Plan for an Upgrade 


3. Make a backup of the encyclopedia, coordination database, and CSE software. 
Important! Protect your model data. 

4. Shutdown the database. 

5. Uninstall the old release. 


6. Upgrade the computer to meet the technical requirements for the new release. 
Follow the instructions of the database vendor for upgrading a database. 


7. Make another backup of the encyclopedia and coordination databases using the 
newly installed database tools. 


8. Install the new CA Gen release and run the following command: 
cse config 
9. Start the new CSE and run post-installation tests. 


10. Proceed with model conversion and toolset upgrade plan. 


How to Upgrade a Model 
After determining the model strategy, upgrade the model. 


Follow these steps: 
1. Checkin all subsets from workstations before upgrading the encyclopedia. 


2. If this model is a child model on the Client-Server Encyclopedia, apply all changes 
with check in to the parent model. 


Note: To convert a model to the current schema, you check in a model fully and it 
cannot be a child model. 


3. Upgrade the encyclopedia. 


4. Usethe Model Conversion Utility on the Encyclopedia, if a schema release change is 
required. 


5. Install the new Workstation Toolset. 


6. Checkout models or subsets and continue your work. 
Develop a Strategy for Existing Application Systems 


Production applications are not directly affected by upgrading the development 
environment. But the model or models on which they are based are directly affected. 
Your strategies for upgrading applications include: 


m  Sufficient testing in the environment to ensure confidence that a new code 
generator does not affect future changes 
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Evaluation of new features to be applied to the application 


Note: For information about z/OS application migration, see z/OS Application Migration 
in the Release Notes. 


How to Upgrade an Application System to CA Gen 


Create a strategy for supporting production systems that are generated before 
COOL:Gen 6.0, during and after conversion to CA Gen Release 8.5. 


Follow these steps: 


1. 


Understand the differences between code that is generated with CA Gen Release 
8.5 and code that is generated with earlier versions. 


Consider the effect of the new features and functions in all releases since the 
current release. 


Review construction procedures. 


Consider the effect of the changes to generation and installation on Release 
Management procedures. 


Create a system inventory. 


Identify the systems to regenerate. For each model, record the following 
information: 


m Ownership 
m Size, such as the number of objects 
Determine an application support option. 


See the section on Application Support options in the Considerations for Application 
Support section and determine the best option for upgrading the system. 


Sequence the application systems to regenerate. 


Determine the sequence for upgrading the application systems. When determining 
the sequence, make the following considerations: 


m  Arethere dependencies between the systems? 
m  Arethere any ongoing development projects on these systems? 


mls the system critical to the business? 


After you determine the systems to regenerate, develop a plan for each system. 
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Template Task List for Regenerating an Application System 


The following lists template conversion tasks for moving an older application into a CA 
Gen Release 8.5 application environment. This task list varies depending on the number 
of older applications in your organization, the size, and expertise of the development 
team, and the development stages of the applications to convert. The task list is not 
based on using a particular component or the release from which you are converting. 
For example, the task list is not dependent on using the Host Encyclopedia or the 
Client-Server Encyclopedia. 


The template task list for regenerating an application system is: 


Pre-system test 

Convert model to CA Gen Release 8.5 

-  Runconsistency check against model 

- Identify and resolve consistency issues 

- Review, document, and fine-tune the data model 
Generate new system and perform preliminary system test 
- Allocate construction libraries 

- Generate database 

— Generate RI triggers 

- Review external action blocks 

- Select load modules for pre-system generation 

- Generate load modules for pre-system generation 
- Test and review selected load modules 

Establish detailed system test plan 

- Establish testing plan and testing sequence 

- Develop system test scripts 

- Load database with test data 

- Assign USER security access to modules 

- Review test system plan 

Suspend new development 


- Limit extra activity on prior schema models 
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System test 


Generate entire system to upgrade 
Complete system test 
Resolve any issues on differences 


Validate entire system test results 


Production implementation 


Convert production models to current schema 


Copy and rebind the plans 


Regenerate system and promote system into production 


Validation 


Validate procedures 


For any major new release, you prepare the plan and the tasks to communicate the new 
features and train those users using the new release. The plan also includes the rollout 
of workstation software to the developers using the new release. 


The following sample rollout plan lists the tasks that are required to communicate the 
new features: 


Establish CA Gen standards 


User interface standards 


Standard OCXs 


DBMS standards 


Develop a training plan 


Determine training needs 


Review the training matrix in the section Recommended Training for CA Gen 
Users 


Determine a workstation implementation plan 


Determine the workstations to upgrade 
Order software, including: 

m CA Gen Release 8.5 

m Compilers, database, and precompilers 
Sequence installation of software 


Test and review installed software 
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Recommended Training for CA Gen Users 


The training required for different types of users is as follows: 
m Project Managers 


Overview of what is available in the new release, including extra functionality and 
platforms available 


m All workstation users 
Toolset training on new features and functions 
m  Constructors and Database Administrators 
Technical design options 
m Constructors 
Toolset training on new features and functions 
m Encyclopedia Administrator 


Host Encyclopedia or CSE training 


Identify Roles and Responsibilities for the Upgrade Team 


When upgrading a CA Gen project, you identify who is responsible for each task. The 
number of individuals depends on the tasks in your detailed plan and the extent to 
which your organization uses CA Gen. 


Address the roles and responsibilities as you assemble the upgrade team. The roles and 
responsibilities are as follows: 
m Project Sponsor 
Overall responsibility for the upgrade 
Understands business drivers that determine the need for an upgrade 
m Upgrade Team Manager 


Responsible for the planning, coordination, and day-to-day management of the 
upgrade 


m Application Specialists 


Available to the project as knowledgeable individuals in the functionality of the 
application being upgraded 


m Systems Administrator 
Responsible for installing and maintaining the encyclopedia environment 
m Database Administrator 


Responsible for general database preparation, maintenance, and support during the 
upgrade process 
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m  CAGen Specialist 


Responsible for knowing all new functionality within CA Gen, and how to take 
advantage of it, for upgrading the application, and for support when required 


m Workstation Administrator 


Responsible for installing all workstation software 
Finalize the Upgrade Plan 


At this stage, you have determined the members of your upgrade team and the scope of 
the upgrade from three perspectives: 

= Models that you want to retain under the new release 

m Application systems that need regeneration 

m Rollout to the organization 

You can prepare the upgrade project plan using a Project Charter and schedule. The 
charter outlines the objectives, goals, critical success factors, and completion criteria for 


the project. The schedule depicts timelines, milestones, tasks, and resources. You 
require several charters and schedules for complex projects. 


Before you start the upgrade project, all parties agree to the charter. Reaching to an 
agreement and the parties that are involved, depends on your organization and the size 
and nature of the conversion. 


The upgrade plan covers the following items: 

m How and when to upgrade the Encyclopedia 

m How and when to test the production systems support 
= How and when to regenerate production systems 

m How and when to upgrade the models 

m = How and when to implement the training plan 


m What changes are required to individuals' roles and responsibilities 


Considerations for Supporting Generated Applications 


You review the referential integrity triggers considerations and the options for 
allocation upgrade considerations when supporting generated applications. 


Referential Integrity Triggers 


Referential Integrity Triggers do not require regeneration unless it is a Java application. 
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Options for Application Upgrade 


If you have a production application that is built with an earlier version of CA Gen, 
upgrading your development environment does not directly affect the application's 
operation. Since most applications require ongoing maintenance to adjust for 
environment and business changes, consider the effect on the overall application of 
regenerating part of the application. 


The goal of model-based development is to define applicable functional requirements, 
regardless of programming language or platform. Ideally, a regenerated part would fit 
seamlessly into an existing application. However, the continuing evolution of the 
technical infrastructure for CA Gen, compilers, teleprocessing monitors, and operating 
systems means that you still test and adapt as you move forward. 


There are several approaches for maintaining systems that are generated under an 
earlier version of CA Gen: 


m Continue support for the model using your current version of the software. 


m  Notupgrading the software avoids transition planning and is appropriate when you 
are likely to drop or replace the system soon. 


m Upgrade the system as part of a systems development project. 


If you plan a major modification or extension of the system, you can use the 
development project as a vehicle for moving toward the current release. During the 
transition period, implement coordination procedures to ensure that emergency 
production fixes are also implemented in the new development model, as 
applicable. 


If you are working with consecutive releases using the same encyclopedia data 
tables, you can work with separate models using different software, and can 
migrate required changes forward. 


m Convert the model to the current schema and regenerate the entire system in the 
current release. 


This option requires regeneration of the entire system using the current release 
code generator and runtime routines. 


The decision to take this option depends on: 


- Availability of regression tools or resources to carry out any system test and 
regression test activities required 


- System size, complexity, and the impact of system down time on the business 


- During the test period for the newly generated system, fixes required using the 
earlier version of the model. You must have a coordination procedure to 
ensure that fixes are not lost during the transition. 


The benefit of this approach is that you can trace all code behaviors to one code 
generator. It is easier to exploit possibilities for performance improvements that are 
offered with the newest releases of CA Gen progressively. 
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Evolve support for new releases. 


Using this option, the application remains as it is. The model on which it is based 
resides in the current release encyclopedia and is converted to the current schema. 
You generate changes to the system as needed, using the current code generator. 
You include any adaptation that is required for the current release, or other 
technical environment changes, in tests for the changed portions of the application. 


You plan some code generation testing during the upgrade to establish a level of 
confidence with the new code generator in your environment and to anticipate 
adaptation requirements. 


This approach depends on some level of compatibility in runtime support between 
the prior and current release in the targeted configuration for the generated 
application. For information about the requirements to migrate to the new release, 
see the Release Notes. 


Chapter 3: Installing CA Gen on the 
Windows Platform 


The installation for Product Software lets you selectively install the CA Gen features. The 
operational details of the CA Gen interactive installation process on the Windows 
platform, including new and maintenance installation details for each product 
component. 


Pre-Installation Checks 


Perform the following pre-installation checks on the Windows systems on which you are 
installing CA Gen: 


The system must meet all hardware and software requirements. For information 
about hardware and software requirements, see the CA Gen Technical 
Requirements guide on the CA website, ca.com. 


Continuing with CA Gen Release 8.5, you can install different releases of CA Gen on 
the same computer. Support varies among components in an environment with 
multiple releases of CA Gen installed. For more information, see Using CA Gen and 
AllFusion Gen Components on the Same Windows System (see page 68). 


For CA Gen features that require a database, the database must be installed and 
operational on the same system on which CA Gen is installed. 
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m The installation does not check licenses. Some CA Gen features install, but require 
that a valid license exists on the workstation at execution time. 


m  Touse Adobe Dreamweaver with CA Gen Studio, install Adobe Dreamweaver 
before installing CA Gen Studio because CA Gen Studio installs the required files in 
the Adobe Dreamweaver installation directory. 


m Close all open applications and windows before starting the installation. 


Select Your Installation Type 


You can install the CA Gen Windows products using the CA Gen Product Browser or 
through a silent installation. The CA Gen Product Browser uses an installation wizard to 
install each product component. 


A silent installation installs the CA Gen components without requiring user interaction. A 
silent installation starts with a DOS command and can be executed so that it does not 
display pop-ups, dialogs, command screens, or other dialogs that require user 
interaction. You can also use the silent installation to repair, modify, or remove an 
existing installation. 


Using the CA Gen Product Browser 


Download the CA Gen Release 8.5 installation setup files from CA Support Online. 


To start an installation using the CA Gen Product Browser, navigate to the CA Gen 
download folder and double-click the setup.exe file. 


The CA Gen Product Browser displays the following set of views of the content that is 
provided on the CA Gen download folder: 

m Documentation and Support 

m Install Products 


m Browse the Contents 


Documentation and Support View 


The Documentation and Support view lists the following information: 
m  Linktothe CA Gen home page on CA Support Online 


m Technical Support phone number 


Click the CA Gen — Support Online link to view the CA Gen product information. Click the 
Main Menu tab to go back to the product welcome screen. 
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Browse the Contents View 


Click Browse the Contents to see the folder structure of the CA Gen download folder in a 
windows explorer. 


Install Product Software 


The CA Gen installation wizard installs CA Gen features to your Windows system. The 
wizard verifies if the user ID performing the installation has Administrator privileges. It 
checks your PC environment and gives you options with prompts based on your 
operating system and the type of installation you choose. 


Notes: 


Before beginning the install, close all open applications and windows. 


You configure CA Gen features before using them. 


Follow these steps: 


1. 
2. 


From the CA Gen Product Browser main menu, click Install Products. 
Click Software. 

Click Next. 

Read the license agreement and click | Agree. 

Select one of the following setup options and click Next: 

Typical 


Installs a predetermined set of product features. The features that are selected 
by default in the Custom installation are the set of features that are included in 
a Typical setup. See Step 8 for the default features list and continue with Step 
6. 


Custom 

You select the features to install. If you chose Custom, continue with Step 8. 
Accept the default path or click Change to create a new one. Click Next to continue. 
Click Install to install the selected CA Gen features on your system. 


CA Gen is installed and ready to use. 
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Using the CA Gen Product Browser 


8. When you chose Custom, you can select the CA Gen features to install and change 
the installation directory. 


15 CA Gen 8.5 


Custom Setup 
technologies 


Select the product features you want installed. 


Click on an icon in the list below to change how a feature is installed. 
Feature Description 


CA Gen features 
provides the 
enterprise level 
flexible application 


This feature requires 5KB on 
your hard drive. It has 16 of 37 
subfeatures selected. The 
subfeatures require 503MB on 
your hard drive. 


Crogan Fles G8 Aer 
InstallShield 


9. Select the CA Gen features you need to install and click Next. 


10. Click Install to install the selected CA Gen features on your system. 
CA Gen notifies you when the installation completes. 


11. Click Finish. CA Gen is installed and ready to use. 


More information: 


CA Gen Features (see page 29) 
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Using the CA Gen Product Browser 


You install the following product features. The installation software installs the Typical 
and Custom features when you click the Typical installation. It installs the Custom Only 
features when you click the Custom installation. 


CA Gen Feature 


Gen Studio 


Workstation Analyst Toolset 


Workstation Development 
Toolset 


Workstation Construction 
Toolset 


Workstation Update API 


Encyclopedia Client 


Setup 
Type 


Typical or 
Custom 


Custom 


Custom 


Typical or 
Custom 


Custom 
only 


Typical or 
Custom 


Feature Description 


A set of designers to model business 
applications. This is the start of the 
migration path of the current 
Workstation Toolset. 


A set of diagrams that model the data 
and activity of a business area. 


The Workstation Analyst Toolset and a 
set of diagrams to design a business 
application. 


A set of generators that transform the 
local model into a complete set of source 
code for an application. If targeting 
Windows, the code is ready to be 
compiled, linked, and tested using the 
Build Tool. For other target 
environments, it creates remote files. 
This option includes the Analyst and 
Developer Toolset diagrams. When 
performing a Typical install, this option 
includes the Workstation Toolset for 
which the machine is licensed. 


A set of C language subroutines for 
extracting and updating model 
information from a CA Gen local 
encyclopedia. 


A pair of Client Server Encyclopedia 
clients that interact with an Encyclopedia 
Server for subsetting, model and subset 
management, user and user-group 
management, and checking models in 
and checking models out. This feature 
includes the Checkout Client and the 
Encyclopedia Client. 
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CA Gen Feature 


Encyclopedia Construction 
Client 


Encyclopedia Version Control 
Kit 


Setup 
Type 


Custom 
only 


Custom 
only 


Feature Description 


A Client Server Encyclopedia client that 
interacts with an Encyclopedia 
Construction Server and transforms a 
model stored in an encyclopedia into a 
complete set of source code for an 
application. The source code is collected 
in remote files, that are later transported 
to the target system where the source 
code is compiled, linked, and tested 
using the Build Tool. 


A Client Server Encyclopedia client that 

creates versions of objects and supports 
migrating them across models stored in 

an Encyclopedia Server. 


Encyclopedia Administration 
Kit 


Encyclopedia Server 


Encyclopedia Construction 
Server 


Encyclopedia Update APIs 


Implementation Toolset 


30 Distributed Systems Installation Guide 


Custom 
only 


Custom 
only 


Custom 
only 


Custom 
only 


Typical or 
Custom 


Client Server Encyclopedia clients that 
perform encyclopedia and user access 
administration and administration tasks, 
including tuning and diagnostics of an 
Encyclopedia Server. This option installs 
the Coordination Client and the Support 
Client. 


A server application managing a 
database repository that stores CA Gen 
models. The Encyclopedia Server 
supports multiple development teams 
and multiple development projects. 


A set of generators that transform a 
model stored in an encyclopedia into a 
complete set of source code for an 
application. The source code is collected 
in remote files, which are later 
transported to the target system where 
the source code is compiled, linked, and 
tested using the Build Tool. 


A set of C language subroutines to 
extract and update model information 
from a CA Gen Encyclopedia. 


A collection of tools to install and run 
generated applications on a target 
system. 


Using the CA Gen Product Browser 


CA Gen Feature Setup Feature Description 
Type 

Diagram Trace Utility Typical or A tool that provides an interactive 
Custom debugging environment for CA Gen 


generated Java, .NET, and C applications. 


GUI Runtime Typical or The runtime environment for generated 
Custom GUI applications. 

Transaction Enabler Typical or A production environment for 
Custom transaction processing. It loads 


application load modules and keeps 
them resident in memory, connected to 
the database, and shareable. 


Transaction Enabler User Typical or A utility that allows more than one user 
Funnel Custom to share a Transaction Enabler TCP/IP 
session. 
Communications Bridge Custom A utility application that provides a 
only communications path between CA Gen 


client applications and a target server 
environment. The Communications 
Bridge supports concurrent sharing of a 
common server connection. 


Client Manager Custom A utility application used by generated 
only GUI client applications to concurrently 
provide communication paths to target 

server environments. 


MOSeries Middleware Custom The runtime support that gives the CA 
only Gen Distributed Processing client/server 
applications the ability to communicate 
using IBM's WebSphere MQ message 
oriented middleware. 


Tuxedo Middleware Custom The runtime support that gives the CA 
only Gen Distributed Processing client/server 
applications the ability to communicate 
using Oracle's Tuxedo middleware. 


TCP/IP Middleware Typical or The runtime support that gives the CA 
Custom Gen Distributed Processing client/server 
applications the ability to communicate 
using stream TCP sockets. 
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CA Gen Feature 


ECI Middleware 


.NET Remoting Middleware 


Java RMI Middleware 


Web Services Middleware 


C Proxy 


COM Proxy 


Java Proxy 


.NET Proxy 


Web View Client 


Java Web Client 
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Setup 
Type 


Custom 
only 


Typical or 
Custom 


Typical or 
Custom 


Custom 


Custom 
only 


Custom 
only 


Custom 
only 


Custom 
only 


Typical or 
Custom 


Typical or 
Custom 


Feature Description 


The runtime support that gives the CA 
Gen Distributed Processing client 
applications the ability to communicate 
to CICS server applications using IBM's 
CICS External Call Interface (ECI). 


The runtime support that gives the CA 
Gen Distributed Processing CH client and 
.NET server applications the ability to 
communicate using Microsoft's .NET 
Remoting middleware. 


The runtime support that gives the CA 
Gen Distributed Processing Java client 
and EJB server applications the ability to 
communicate using Java RMI 
middleware. 


The runtime support that gives the CA 
Gen Distributed Processing client/server 
applications the ability to communicate 
using Web Services Middleware. 


The runtime environment that supports 
user-written C Proxy client applications. 


The runtime environment that supports 
user-written COM Proxy client 
applications. 


The runtime environment that supports 
user-written Java Proxy client 
applications, applets, servlets, JSPs, and 
EJBs. 


The runtime environment that supports 
user-written .NET Proxy client 
applications. 


The runtime environments and 
generation capability necessary to 
execute customizable CA Gen 
HTML-based clients that use Web 
Services. 


The runtime environments and 
generation capability necessary to 
execute CA Gen browser-based clients 
running under a Java Application Server. 


Using the CA Gen Product Browser 


CA Gen Feature Setup Feature Description 
Type 

ASP.NET Web Client Typical or The runtime environments and 
Custom generation capability necessary to 


execute CA Gen ASP.NET clients running 
under Internet Information Services (IIS). 


.NET Servers Typical or The runtime environment for generated 
Custom .NET server applications. 

Enterprise JavaBeans Custom The runtime environment for generated 
only J2EE server applications. 

CFB Converter Services to Custom A data format conversion service for 

Enterprise JavaBeans only generated CA Gen GUI clients or C and 


COM Proxies that need to interact with 
Enterprise JavaBeans Servers. 


Gen Plug-Ins Custom CA Gen applications that add 
functionality to the CA Gen Toolset. 


Web Services Wizard Plug-In Custom Provides a web service interface to Gen 
servers via the Java proxy. 


Note: The Web Service Wizard Plug-In 
was formerly available as a separate 


installable. 
CA Gen z/OS DB2 Table Custom Allows table partitioning data to be 
Partitioning Plug-in entered into a model and used when 


generating DDL targeting z/OS DB2. 


CA Gen z/OS DB2 Tablespace Custom Allows tablespace partitioning data to be 
Partitioning Plug-in entered into a model and used when 
generating DDL targeting z/OS DB2. 


Perform a Maintenance Installation 


You can modify, repair, or remove a CA Gen Product Software component installation. 
Use Modify to alter the set of Gen Component features installed on the workstation. 
Repair reinstalls previously installed features and returns the feature to the same state 
as a new installation. Remove uninstalls all CA Gen component features previously 
installed on the workstation. 


Follow these steps: 
1. Onthe CA Gen Product Browser main menu, click Install Products. 


2. Click Install Product Software and click Next. 
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Using Silent Installation to Install CA Gen Product Components 


3. Select one of the following options: 
Modify 
Changes the CA Gen features. 
Repair 


Repairs the set of CA Gen features installed on a workstation and fix corrupt 
files, shortcuts, and registry entries. 


Remove 
Deletes a CA Gen component from the system. 


4. Follow the installation prompts to change your installation. 


Access Product Documentation 


The CA Gen Product Documentation is available on CA Support Online. You can either 
download the documentation or view it online at http://ca.com/support. 


Note: For more information about the CA Gen product documentation, see the Release 
Notes. 


Using Silent Installation to Install CA Gen Product Components 


Use the command line utility 'msiexec' to start an unattended, or silent, installation of 
CA Gen product components. This installation process eliminates the need for user 
interaction and executes without pop-ups, dialogs, command screens, or other dialogs. 
You can use a silent installation, to perform a new installation, repair an existing 
installation, modify an existing installation, or remove an existing installation of the CA 
Gen product software. 


Silently Install CA Gen Product Software 


To silently install CA Gen Product Software component features, execute the following 
command: 


msiexec /i | /f | /x "CA Gen 8.5.msi" [ADDLOCAL-specific product features of Gen] 
[REMOVE- specific product features of Gen] [INSTALLDIR-installation directory] [/qn 
| /qb] 


Where: 
fi 


Installs or configures a product. 
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/f 


Repairs a product installation. This option ignores any property values entered on 
the command line. 


/x 


Uninstalls a product. This option ignores any property values entered on the 
command line. 


You must specify /i, /f, or /x. The options /i, /f, or /x corresponds to three options, which 
are Modify, Repair, and Remove, described in the section Perform a Maintenance 
Installation (see page 33). When you omit them, msiexec displays a usage message. 


"CA Gen 8.5.msi" 
The msi file to install CA Gen. Enclose the MSI file name in double-quotes. 
ADDLOCAL 


An optional argument that defines the set of product features to install. When you 
omit the ADDLOCAL argument, it performs a Typical install. 


This list is the CA Gen product features you can install during a Custom installation. 
Separate multiple features with a comma. For a description of each feature, see the 
Install Product Software. 


m Gen Studio 

m Workstation Analyst Toolset 

m Workstation Development Toolset 
m Workstation Construction Toolset 
m Workstation Update API 

m Encyclopedia Client 

m Encyclopedia Construction Client 


m Encyclopedia Version Control Kit 


m Encyclopedia Administration Kit 
m Encyclopedia Server 

m Encyclopedia Construction Server 
m Encyclopedia Update APIs 

m Implementation Toolset 

m Diagram Trace 


m GUIRuntime 


m Transaction Enabler 
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m Transaction Enabler User Funnel 
m Communications Bridge 

m Client Manager 

m Middleware MOSeries 

m Middleware Tuxedo 

m Middleware TCPIP 

m Middleware ECI 

m Middleware dotNetRemoting 

m Middleware JAVARMI 

m Middleware Web Services 

m Proxy Programming Interface C 

m Proxy Programming Interface COM 
m Proxy Programming Interface Java 
m Proxy Programming Interface NET 
m Web View Client 

m Web Generation Java 

m Web Generation ASPNET 

m  DotNetServers 

m  EnterpriseJavaBeans 

m  CFB Converter Services to EJBs 

m Plugins 

m WebServiceWizard 

m  TablePartitioning 

m  TableSpacePartitioning 


REMOVE- 


An optional argument that defines the set of product features to be removed. The 
features described in "ADDLOCAL-" option can be used on this option. 


INSTALLDIR- 


Designates the path for installation. msiexec installs to the default directory when 


you omit this parameter. 


/qn 


Specifies a silent installation, without display. 
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/qb 


Specifies to only display the progress dialog. 
These options are subset of the options that can be used for ‘msiexec’ command. For 
more detail of each command and other options, refer the following Microsoft Online 
Knowledge Base. 
http://support.microsoft.com/kb/314881 
http://support.microsoft.com/kb/230781 
The following are some commonly used silent installation commands: 
To install only the Toolset 


msiexec /i "CA Gen 8.5.msi" ADDLOCAL-Workstation Development Toolset /qn 


To install the development and construction Toolset 


msiexec /i "CA Gen 8.5.msi" ADDLOCAL-Workstation Development Toolset, 
workstation Construction Toolset /qn 


To perform a typical installation 

msiexec /i "CA Gen 8.5.msi" /qn 

To install all product features 

msiexec /i "CA Gen 8.5.msi" ADDLOCAL-ALL /qn 

To repair the existing installation on the computer 
msiexec /f "CA Gen 8.5.msi" /qn 

To remove the existing installation from the computer 


msiexec /x "CA Gen 8.5.msi" /qn 


Verify the Installation 


This section explains how to verify the CA Gen product components and features 
successfully installed on a Windows workstation. Different components require 
different verification processes. For some components, verifying the installation 
includes ensuring the Add or Remove Programs dialog lists the component. 


The Windows Start Menu includes a shortcut or folder for every installed component. 
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Verify Add or Remove Programs includes Installed Components 


The installation software creates separate entries in the Windows Add or Remove 
Programs dialog when you install CA Gen Release 8.5. 


If you installed CA Gen Release 8.5, verify they are in the Windows Add or Remove 
Programs dialog. 


Verify the Windows Start Menu Includes Installed Components 


Verify the Windows Start menu includes a shortcut or a folder for every component you 
installed. To do so, click Start, All Programs, CA, Gen xx. 


Note: xx refers to the current release of CA Gen. For the current release number, see 
the Release Notes. 


The Gen xx menu may include: 
m Folders for these components: 
-  CSEServers 
- CSE Clients 
m Shortcuts for these components: 
- Communications Bridge 
- Documents 
- Diagram Trace Utility 
- Build Tool 
-  Toolset 
- Client Manager 
- Communications Bridge 


- Gen Studio 


Verify Toolset and Construction 


m Verify you can open the Gen Sample Model. The CA Gen Sample Model is in the 
same directory as the CA Gen Toolset. 


m Verify the Toolset menu bar includes the Planning, Analysis, and Design menus and 
that they are enabled. 


m Verify you can generate and install the CA Gen Sample Model. For detailed 
information about generating each application type, see the section CA Gen Sample 
Model in the Chapter "Generating Local and Remote Applications" in the 
Workstation Construction User Guide.. 
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Verify CSE Clients 


Verify CSE Servers 


Creating a Copy of the Sample Files 


m Verify the specific CSE client you installed has a short cut added to the CSE Clients 
folder. 


m Verify that short cut entry for each CSE Client application you installed opens the 
application. 


Verify that each short cut added to the CSE Servers Start Programs folder starts the 
program. 


Creating a Copy of the Sample Files 


The installation software copies CA Gen sample files to the directory defined by 
%GENxx%. Standard user privileges do not permit access to change files in that 
directory. Every user that wants to work with the sample files must make a working 
copy of the sample files in a directory to which they have write privileges. 


Note: xx refers to the current release of CA Gen. For the current release number, see 
the Release Notes. 


The user should copy the files from the %GENxx%Gen\samples directory to the 
destination directory. There are many ways to copy the files. For example, these steps 
create a copy of the Sample files in the My Documents folder: 
Follow these steps: 
1. In Windows Explorer, in the Address bar, type: 

%GENXx%s 
2. Press Enter. 


3. Press and hold the Ctrl key while dragging and dropping the Samples folder to the 
My Documents folder. 


C Application Configuration File Directories 


Microsoft Windows 7 and Windows Server 2008 introduced a new security model, User 
Account Control (UAC), to improve operating system security. The directories in which 
CA Gen stores C application configuration files changed to support the new security 
model. Windows 7 and Windows Server 2008 store files in different directories. The 
following lists define the directories: 


m in which Windows formerly stored the file, if that directory existed on the system 
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Using Windows Add or Remove Programs to Uninstall CA Gen Product Components 


m  thedirectory in which Windows 7 stores the file 
m the directory in which Windows Server 2008 stores the file 
Note: xx refers to the current release of CA Gen. For the current release number, see 
the Release Notes. 
CA Gen stores the following files, used by the GUI Runtime, in the following directories: 
m  iefgdic.ini 
m %IEFGDIC% (if defined) 
m %USERPROFILE%\AppData\Local\CA\Gen xx\cfg\client (per user) 
m %ALLUSERSPROFILE%\CA\Gen xx\cfg\client (per system) 
m  GUlEnvironmentVariables.ini 
m  TheLoad Module directory 
m %USERPROFILE%\AppData\Local\CA\Gen xx\cfg\client (per user) 
m %ALLUSERSPROFILE%\CA\Gen xx\cfg\client (per system) 


m %GENxx%Gen (where the installed copy is kept) 


CA Gen stores the following files, used by the Build Tool, in the following directories: 
m  system.profile 
m %ALLUSERSPROFILE%\CA\Gen xx\cfg\buildtool 
m  user.*.profile 
m %USERPROFILE%\AppData\Local\CA\Gen xx\cfg\buildtool 
m  user.configure 


m %USERPROFILE%\AppData\Local\CA\Gen xx\cfg\buildtool 


Using Windows Add or Remove Programs to Uninstall CA Gen 
Product Components 


Use the Windows Add or Remove Programs option to uninstall CA Gen product 
components installed on the workstation. 
Follow these steps: 
1. Click Start, Settings, Control Panel. 
The Control Panel opens. 
2. Double-click Add or Remove programs. 


Windows opens the Add or Remove Programs dialog. 
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Uninstall CA Gen Product Components on Windows Server 2008 


3. Select the CA Gen product component to uninstall. 


4. Click Change/Remove 


The uninstall process can take several minutes. 


Uninstall CA Gen Product Components on Windows Server 
2008 


Use the Programs and Features option to uninstall CA Gen product components on 
Windows systems. 
Follow these steps: 
1. Select Start, Settings, Control Panel. 
The Control Panel opens. 
2. Double-click Programs and Features. 
Windows opens the Uninstall or change a program dialog. 
3. Select the CA Gen product component to uninstall. 


4. Click Uninstall Items. 


The uninstall process can take several minutes. 


Using Antivirus Software 


While installing CA Gen products on Windows, the antivirus on your computer may flag 
certain files, specially the IEFCB85n.dll file as suspicious or infected. These warnings are 
"false positives" and result from heuristic scanning algorithms employed by the antivirus 
software. 
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Chapter 4: Installind CA Gen on UNIX and 
Linux 


You install the CA Gen Implementation Toolset (IT) on a Linux-based system, and the 
Implementation Toolset (IT) and Client Server Encyclopedia (CSE) Servers on a 
UNIX-based system. 


Notes: 


m For more information about the configuring and using the Implementation Toolset 
in a UNIX or Linux environment, see the UNIX and Linux Implementation Toolset 
User Guide. 


m  Formore information about the configuring and using the CSE, see the Client-Server 
Encyclopedia User Guide. For information about CSE operation, administration, and 
performance tuning, see the Client-Server Encyclopedia Administration Guide. 


Mounting Instructions 
The CA Gen x.x IT and CSE for UNIX and Linux is now distributed as an ISO file. 


Note: x.x refers to the current release of CA Gen. For the current release number, see 
the Release Notes. 


To mount the ISO file, perform the following instructions: 


Mountind on Linux 


Run the following commands to mount the ISO file on Linux platform. 


# mkdir —p {temporary mount location) 
# mount —o loop {iso file} {temporary mount location} 


Example 


# mkdir —p /mnt/iso-disk 
# mount —o loop /tmp/CAGen85.Linux.iso /mnt/iso-disk 
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Mounting Instructions 


Mountind on Solaris 


Mounting on AIX 


Run the following commands to mount the ISO file on Solaris platform. 


# mkdir —p {temporary mount location} 
# lofiadm —a {iso file} (lofiadm creates a mountable device) 
# mount —f hsfs —o ro {device} {temporary mount location) 


Example 


# mkdir —p /mnt/iso-disk 
# lofiasdm —a /tmp/CAGen85.Solaris.iso 
# mount —F hsfs —o ro /dev/lofi/1 /mnt/iso-disk 


Use the following information to mount the ISO file on AIX platform. 


Follow these steps: 
1. Obtain the size of the ISO image. 
Example: 


ls -la /tmp/CAGen85.AIX.iso 
-rwxr-xr-x 1 root system 253929472 Dec 26 16:05 /tmp/CAGen85.AIX.iso 


2. Identify the nearest multiple of 128 MB that will provide enough space for the 
image. 


In our example, the image is approximately 254 MB, so use 256 MB as an image 
size. 


3. Make a logical volume of this size. Ensure that there is enough space on the physical 
volume. 


For example, hdiskO. 
3 mklv -y cdlv -s n -L /dev/cdlv rootvg 256M hdisk0 
4. Ifthe command fails, increase the volume size by a multiple of 128. 


5. Tocreate a pseudo-device, use the dd command. Ensure that the partition has 
enough space for the pseudo-device. 


In the following example command, the pseudo-device is /dev/cdlv. 

# dd if=/tmp/CAGen85.AIX.iso of=/dev/cdlv 

Note: This command may take a long time and creates two dd processes. 
6. Mount the device like a CD-ROM in AIX. Ensure that the mount point exists. 


# mkdir -p /mnt/iso-disk 
# mount -v cdrfs -o ro /dev/cdlv /mnt/iso-disk 
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Mountind on HP Itanium 


Use the following information to mount the ISO file on HP Itanium platform. 


Follow these steps: 


1. 


Download the free software depot ISOIMAGE-ENH from the HP software web-site. 
Install the software depot with swinstall. 


The above mentioned package also contains four patches to patch mount and 
umount commands to deal with CDFS format. 


Type the following command to install the depot: 
swinstall —s $PWD/ISIMAGE.depot 


Before mounting an ISO image load the Dynamically Loadable Kernel Module 
(DLKM) named fspd. To load and unload the fspd module after installing the depot, 
use the following commands: 


m Toload: 
kcmodule fspd-loaded 
m To unload: 
kcmodule fspd=unused 
Mount the ISO image as follows: 
mount -F cdfs /tmp/CAGen85.HPIA64.iso /tmp_mnt 
To view the mount options, type the following command: 


mount -v | grep /tmp_mnt 
/dev/fspd1 on /tmp mnt type cdfs imagepath=/tmp/CAGen85.HPIA64.iso inode-46218 
residing on blockdevice 0x40000003, ro, rr,dev=6000001 on Thu Jan 3 15:12:41 2013 


Unicenter Software Delivery 


CA Gen Release 8.5 uses the Unicenter?utility named Unicenter Software Delivery (USD) 
to install and uninstall the CSE and the IT. Similar to Microsoft's MSI on Windows, USD 
installs software on UNIX and Linux systems. 


CA Gen Release 8.5 includes the USD Installer utility. The setup program installs the 
installer utility on your system. Setup uses the installer to install the IT and the CSE. You 
can install the IT and the CSE simultaneously or at different times using the setup 
program. 
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Naming Considerations 


The installer utility that performs the installation is named Ism. After completing an 
installation, you can use Ism to view information about the installed product including 
name, version, parameters, and file lists. You can also use Ism to delete an entire 
product or run Ism without parameters to view the usage message. 


Note: If your site has the full Unicenter Software Delivery product, available under a 
separate license for managing the remote distribution of applications in an enterprise, 
you can register CA Gen Release 8.5 for remote distribution. CA Gen Release 8.5 is in the 
CA Gen download folder in the required PIF format for supported UNIX and Linux 
platforms. For the details on how to register and distribute PIF formatted products, see 
your USD documentation. 


Naming Considerations 


For releases before AllFusion Gen 7, administrators used UNIX commands to install and 
remove the CSE and the IT on UNIX systems. Software components that are installed 
with USD have no knowledge of other components installed using UNIX commands. USD 
installs and uninstalls without knowledge or concern for releases that precede AllFusion 
Gen 7. 


USD can install multiple instances of one or more releases of CA Gen, allowing you to 
install and test the new release without interrupting the use of the earlier release. If you 
need multiple configurations of a single release, you can install two instances of the 
same release. 


You can leave earlier release in place when installing CA Gen Release 8.5 unless you 
install to the same directory. In this case, remove the earlier release before installing 
another release. USD informs the user and abandons the installation if you attempt an 
update to the same directory. 


The CA Gen USD installation supports multiple instances of Gen by using a unique name 
and location for each instance. It effectively creates separate products whose name is 
the concatenation of CA Gen and the unique instance name that is separated by a 
period. Include the unique instance name on the command line every time you execute 
the setup and USD utility programs. The syntax is: 


./setup -I instance name 


instance name is any unique text string. The -I argument changes the product name 
that is registered with the CA installation subsystem to CAGen.«instance name». 


Components that are installed using USD must conform to certain practices: 


m Instance names must be unique across releases. Within a release, the IT and the 
CSE can use the same named instance, even when installed at different times. The 
single unnamed instance is the same as any named instance except omit the -I 
argument. 
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Installation 


Installation 


m Since all instance names and locations must be unique, to reuse the name or the 
location, uninstall the previous instance before setup can create the new instance. 
The setup program enforces this restriction to prevent updates to earlier releases. 


Note: When you uninstall an instance, setup includes a checkbox to save the 
configuration files, including unmodified configuration files. Setup checks the box 
by default. If you uncheck the box, uninstall removes all files including the 
configuration files. 


Starting with AllFusion Gen 7.5, during a subsequent install, the installation 
automatically renames configuration file in the target install location to prevent 
overwriting these files. A modification to a configuration file requires the same 
modification to the newly installed version of that file. 


For information about the configuration files the IT uses, see the UNIX and Linux 
Implementation Toolset Guide. 


m CA Gen does not support upgrade in place. You cannot install CA Gen Release 8.5 as 
an upgrade to AllFusion Gen 7.5 or AllFusion Gen 7.6. 


m After installing a named or unnamed instance, remove the instance before you can 
change its location. 


Note: To simplify future upgrades, set up a consistent naming convention for your IT 
and CSE instances. 


Only the root user can install. For security reasons, the root user must enter a non-root 
user name and group to own the installed files. This user and group must exist on the 
target host before starting the installation. 


During installation, CA Gen displays the End User License Agreement. To scroll through 
the text in the agreement, use plus (+) or Shift plus (+) to move forward, and minus (-) of 
Shift minus (-) to move backward. 


When installing on AIX, run the slibclean command before uninstalling software to 
release the shared libraries in memory. To run the slibclean command requires root 
privileges. 


The format of the CA Gen download folder has a root directory with only a single setup 
executable and one subdirectory that is named for each supported platform. Running 
the root setup identifies the current platform and transfers control to the setup in the 
appropriate platform subdirectory. Before installing files, the installation process 
gathers information that it uses during the install. 
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Preparing to Install the Implementation Toolset 


To simplify installing CA Gen on multiple computers, you can copy the platform 
subdirectory to a hard disk and can run the setup program that is located in that 
subdirectory of the platform. 


Each platform subdirectory contains a PIF formatted archive to register with the 
Unicenter Software Delivery, a centralized distribution product for remote delivery. 


Preparind to Install the Implementation Toolset 


Before installing the Implementation Toolset (IT), perform the steps. 


Follow these steps: 


1. 


Back up previous releases of the IT. 
Note: The USD does not recognize IT releases that precede AllFusion Gen 7. 


After installing a named or unnamed instance, remove it to change its location. To 
uninstall an earlier release, use the setup file in the CA Gen download folder or use 
the USD utility program Ism automatically installed on the system with the release. 
To view the Ism program's arguments, type Ism without any arguments. 


You can change the target directory of the IT software. 


Ensure that the target location for the IT installation has at least 160 MB of disk 
space. 


Preparing to Install the CSE 


Before you install the Client-Server Encyclopedia, perform these steps. 


Follow these steps: 


1. 


Verify that all models, subset, or child models are checked in. 


Important! You lose work if you fail to perform this step. You will not be able to 
check in models or subsets that are created with the Second Prior Current Schema 
after installing CA Gen Release 8.5. 


Note: For the schema designation for Current Schema, Prior Schema, and Second 
Prior Schema, see the Release Notes. 
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First Time IT or CSE Installation 


Ensure that the target location for the CSE installation has sufficient disk space. The 
following platforms require this amount of free disk space: 


m HP Itanium requires 600 MB 
m AIX requires 850 MB 


Shut down all components of the installed CSE. There should be no programs 
running in the CSE owner account while installing the CSE. 


To check for programs running in the CSE owner account, cseadmin, run this 
program show (ps) command: 


$ ps -u cseadmin 


The primary components are iefmd and iefrds. 


When the system includes a CSE release that precedes AllFusion Gen 7, back up the 
earlier release of the CSE and the CSE databases. 


Note: The USD does not manage the CSE releases that precede AllFusion Gen 7. 


When updating from Advantage Gen 6.5 or an earlier release, we recommend using 
a different directory than the previous release for the CA Gen Release 8.5 CSE 
installation. If you are using the same location for your installation, delete the 
previous release except for the following files: 


<install-dir/iefcse.csh 
<install-dir/iefcse.sh 

<install-dir>/exe/ds.cfg 
<install-dir>/exe/es.cfg 


Bring the computer system up to the Technical Requirements. Install CPU upgrades, 
memory upgrades, operating system upgrades, and DBMS releases as specified in 
the Technical Requirements. 


First Time IT or CSE Installation 


Although you need a root account to install CA Gen products, root should not own the 
product files. The USD creates and modifies root-controlled files to manage the 
installation. 


Follow these steps: 


1. 


Log in as a root user to begin the installation process on all UNIX and Linux 
platforms. 


Note: The root user must be using the Bourne shell, sh, or one of its descendants, 
ksh or bash. 


Create UNIX or Linux user login accounts and groups for the IT and for the CSE, if 
they do not exist. You can use the same user for both components. These users own 
the installation after it finishes. To increase security, the user and group cannot be 
privileged accounts such as root or sys. 
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First Time IT or CSE Installation 


3. Change directories to the CA Gen download folder and execute the setup program: 
cd /«CA Gen download folder» 
./setup (or ./setup -I instance name) 


Note: The Installation dialogs display in Graphical User Interface (GUI) mode or 
VT100 mode (character terminal interface). When these conditions exist, dialogs 
display in GUI mode: 


m The JRE release that is defined in the Technical Requirements is available, enter 
the following command to know the JRE version: 
java -version 


m You have an X Terminal or an X-Terminal emulator on your desktop. 

m Your DISPLAY environment variable is set appropriately for your X-Terminal. 
m The Java \bin directory must be in your PATH. 

m Set JAVA_HOME to the directory in which Java is installed 


m When these conditions fail to exist, the dialogs display in VT100 mode. To force 
VT100 mode, use the -V argument with setup. 


Note: Dialogs are presented in this chapter using VT100 mode. 


A Welcome screen opens the first time that you install this release of CA Gen: 


Welcome to the CA Gen setup wizard. 


This process will install version number: 
8.5 


Copyright (c) 2013, CA. All rights reserved. 


Visit https://support.ca.com/ in order to review the Release Notes and User 
Documentation. 


To continue, click next. 


[ Next ] [ Cancel ] 


4. Select Next and press Enter to continue. 


The Licensing screen opens. 
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First Time IT or CSE Installation 


5. After reading the license agreement, scroll to the bottom of the license agreement 
and press the button to indicate you accept the terms of the license agreement. 


Implementation Toolset 


To install the Implementation Toolset (IT) including the communcation daemons, 
select the checkbox and enter the user and group who will own the IT 
installation tree. Using root should be avoided for security reasons. This user 
and group must already exist. 


Install IT: [X] 


[ Back ] [ Next ] [ Cancel ] 


6. Complete the fields in the Install Implementation Toolset screen. 
Install IT 
Leave the X to install the IT. Remove the X to skip IT installation. 
Owner 


Specify the name of the user who owns the IT installation tree. This is a 
mandatory field and there is no default. The system running the installation 
validates the input value. 


Group 


Specify the name of the group that owns the IT installation tree. This is a 
mandatory field and there is no default. The system running the installation 
validates the input value. 


Note: For security reasons, do not use root or one of the system-defined 
groups. 


IT directory 


Enter the name of the directory in which to install the IT. In GUI mode, you can 
use the Browse button to the right of the field. 


Note: The install creates the installation directory if necessary. Root owns the 
installation directory when the install creates it. If the directory exists, 
ownership does not change. The IT user must have permission to create objects 
in the installation directory. If the designated owner does not have permission 
to own the installation directory, the process terminates and writes an error to 
the log file and std.out. 
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First Time IT or CSE Installation 


7. Click Next. 


Client Server Encyclopedia 

To install the Client Server Encyclopedia (CSE) or its Update API, select the 
appropriate checkboxes and enter the user name who will own the Encyclopedia 
installation tree. This user may be different than the Implementation Toolset 
owner. Using root should be avoided for security reasons. This user and group 
must already exist. 

Install CSE: [X] 

Install Update API: [ ] 

Owner: 


Group: 


CSE Directory: /opt/CA/CAGen 


[ Back ] [ Next ] [ Cancel ] 


8. Complete the fields on the Install Client-Server Encyclopedia screen. 
Install CSE 
Leave the X to install the CSE. Remove the X to skip the CSE installation. 
Install Update API 


Enter an X to install the encyclopedia Update API. Leave it blank to skip 
installing it during this installation. 


Owner 


Enter the name of the user that owns the encyclopedia installation tree. This is 
a mandatory field and there is no default. The system running the installation 
validates the input value. 


Group 


Enter the name of the group that owns the encyclopedia installation tree. This 
is a mandatory field and there is no default. The system running the installation 
validates the input value. 


Note: For security reasons, do not use root or one of the system-defined 
groups. 
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10. 


11. 


First Time IT or CSE Installation 


CSE Directory 


Enter the name of the directory in which to install the CSE. In GUI mode, you 
can use the Browse button to the right of the field. 


Note: The install creates the installation directory if necessary. Root owns the 
installation directory when the install creates it. The designated owner must 
have permission to create objects in the installation directory. If the designated 
owner does not have permission to own the installation directory, the process 
terminates and writes an error to the log file and standard out (stdout). 


Click Next. 


The Summary screen opens so you can review the parameters. Click Back to change 
parameters. 


Click Install Product to start the installation process. 


When the installation completes, it offers the opportunity to view the CA Gen 
Readme file. 


The installation of CA Gen has executed successfully. 


[ View Readme ] Shows installation notes, latest changes, and fixes. 


More information concerning the details of this interaction can be found in the the 
directory /opt/CA/installer/log 


Note: If this installation is the first installation of the IT or CSE on this system, 
update user accounts that need access to these products to provide that access. If 
this installation is an update to an existing installation, change the CA Gen defined 
environment to point to the new release of the IT or CSE for user accounts that 
have access to these newly installed products. 


Notes: 


For more information about configuring and using the CSE, see the Client Server 
Encyclopedia User Guide. 


For more information about CSE operation, administration, and performance 
tuning, see the Client Server Encyclopedia Administration Guide. 


For more information about setting the environment variables, see the UNIX and 
Linux Implementation Toolset Guide. 
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Viewing Installation Log Files 


If you installed the IT, it also installed the daemons for the Transaction Enabler. For 
more information about daemons for Transaction Enabler, see the Transaction Enabler 
User Guide. 


The installation delivers a number of configuration files with the IT. Configuration files 
are files that you can modify after installing the IT. These files include build script files, 
initialization files, sample files, and user exit files. When you install the IT, you must 
modify some configuration files and must rebuild libraries and applications. For more 
information about the configuration files that are used by the IT, see the UNIX and Linux 
Implementation Toolset Guide. 


When you install the CSE, configure it before you can use it. For more information about 
configuration, see the Client Server Encyclopedia User Guide. 


Viewing Installation Log Files 


The CA Gen log file details the most recent installation process for each instance and 
type of action; install, reinstall, and uninstall. This file is located in: 


/opt/CA/installer/log/CAGen.instance name.[install | reinstall | deinstall].log 


Note: For the installations specifying a named instance, the file name includes the 
named instance. 


The installation.log file contains the historical summary of all installation and 
maintenance activities for CA Gen Release 8.5. The most recent activities are appended 


to the file in: 


/opt/CA/CAGen/installation. log 
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Uninstall the IT or CSE 


Uninstall the IT or CSE 


To uninstall the IT or CSE, use the USD Ism utility that was installed during the original 
product installation. The Ism utility manages the CAGen installed products. 

Use the following command sequence to uninstall CAGen: 

Ism -l | grep CAGen 


Lists all installed products which contain "CAGen" in the product name. All IT and 
CSE installations, no matter what instance name was given when installed, contains 
"CAGen" in the product name. 


Ism —e «product name> 
Removes the «product name» provided. 
More information about the Ism utility can be found by issuing the Ism command 


with no arguments. 


Note: Root permission is required to remove a product. 


Unattended Installation for IT and CSE 


You can install a new installation without user intervention. To prepare for a new 
installation, see Naming Considerations in the guide. 


You do the silent installation on UNIX or Linux. 


Follow these steps: 
1. Create the response file. 


2. Atthe command line, change directory to the location of the CA Gen download 
folder. 


3. Start setup with the -a parameter to start ask mode to create a response file that 
contains installation details. 


./setup -a directory and filename of the response file 
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Unattended Installation for IT and CSE 


The subsequent installations use the response file in silent mode. 


Setup navigates through the installation steps. select the options as if you were 
installing. The installation process only collects information required to install. 


After the collection process completes, start setup in silent mode and specify the 
response file that is created as: 


./setup -r directory and filename of the response file -s 
-r 


Specifies the response file. 


Indicates to start the installation in silent mode. 
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Chapter 5: Installing CA Gen on NonStop 


The CA Gen Implementation Toolset (IT) includes tools for building and testing 
generated applications on NonStop. Knowledge about the NonStop operating system, 
system utilities, and the file system to perform tasks is helpful. You require access to a 
system administrator user id. 


Note: For more information about CA Gen requirements on HP NonStop, see the 
Technical Requirements Guide available at http://ca.com/support/. For information 
about how to configure and use the IT for building generated applications on NonStop, 
see the NonStop Implementation Toolset User Guide. 


Support for SQL/MX was added with CA Gen 8.5. To take advantage of generated 
applications targeting SOL/MX, an additional set of files are installed under the NonStop 
OSS environment. For more information about installing support for SQL/MX, see 
Installing Support for SQL/MX (see page 64). 


Installation Considerations for NonStop 


With CA Gen, you develop and generate an application on one platform and build it in a 
target environment you create on a different platform. Before building a distributed 
processing application on NonStop, you install the Implementation Toolset (IT) to 
establish the target environment. 


The IT uses TACL environment variables that specify paths and other configuration 
information. 


Note: For information about using TACL, see the HP NonStop documentation. 


IT installation involves running macros that prompt you to enter or accept default values 
for site-specific configuration information for NonStop. Specify the following details to 
install the Implementation Toolset: 


m The #PMSEARCHLIST environment variable includes a list of the volumes and 
subvolumes to search for program and macro files. 


m The MAKEHOME macro called to set #PMSEARCHLIST. 

m  TACLCSTM file customizes your individual TACL environment. 

m  TACLLOCL file customizes the TACL environment for all users of a NonStop system. 
m  Pathmon process name to assign to the Setup Tool. 


m Terminal that is used as the home terminal on NonStop for various processes that 
are related to the IT and the Setup Tool. 
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Installation Prerequisites 


Group and user ID ownership for Implementation Toolset files. 
Location to use for the IT installation. 


Read access to the SSYSTEM.SYSTEM.PATHTCP2 file. The installation process makes 
a copy of this file during the Setup Tool installation. 


Rules for naming files on the file system. 


The Setup Tool must be able to register its application catalog against the SQL/MP 
system catalog during the installation process. 


Installation Prerequisites 


Before installing the CA Gen Implementation Toolset (IT) for NonStop, complete the 
following tasks: 


Confirm the NonStop server meets the hardware and software requirements for 
installing CA Gen. See the CA Gen Release 8.5 Technical Requirements document. 


Note the location of configuration files that contain site-specific customizations for 
running the IT at your site. You can customize the configuration files after IT 
installation. 


Consider file security and file ownership requirements when selecting a location to 
install the IT. Each NonStop system is managed differently and file system access 
may be based on the location of files, the file security vector, the logged in group 
and user ID, or a combination of these attributes. If you are not the system 
administrator for the NonStop server on which you are installing the IT, consult the 
system administrator for information about applicable security and access details. 


The installation procedure lets you set site-wide Pathway and compiler settings. 
When set, the Setup Tool can use these settings during CA Gen application 
installation on NonStop. Review the configuration parameters for Pathway and for 
the compilers with your system administrator. Consider the operation of the 
generated applications to be built when determining if changes are required. An 
experienced NonStop system administrator address changes to the configurations 
of Pathway and compilers on the NonStop server. 


To report build-time events, you can incorporate the optional Event Management 
Subsystem (EMS) templates for the Setup Tool into the EMS templates for the 
NonStop operating system. The EMS templates enhance Setup Tool application 
troubleshooting. Run the INSTTMPL macro as user SUPER.SUPER to make this 
change to the NonStop system configuration. 


Regardless of whether the EMS templates are installed, to ensure that the built-in 
EMS viewer in the Setup Tool can correctly display EMS messages, the security 
vector for the collector's log files must allow network read access. Failure to 
correctly set security settings result in a security violation error (Error 48). The 
collector's log files are usually in the SSYSTEM.ZLOGxx subvolume, where xx is the 
current OSIMAGE identifier. 
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How to Install the Implementation Toolset on NonStop 


Use caution when partially reinstalling the IT after the initial installation. Review the 
existing targets that need configuration data that is preserved to avoid accidentally 
deleting data. For example, if you Select the Create Setup Tool Database option on 
the Setup Tool Install Menu, you lose existing target configuration data for that 
instance of the Setup Tool. 


Consult the NonStop system administrator to determine the maximum number of 
simultaneous installations and the maximum number of compilations the Setup 
Tool can run simultaneously. The combination of these two factors can substantially 
impact the system performance. IT installation macros include options for setting 
these values. These values can also be set after installing the Setup Tool. Doing so 
requires knowledge on how to modify Pathway configuration files. 


How to Install the Implementation Toolset on NonStop 


Complete the following steps to install the Implementation Toolset (IT) on NonStop: 


Follow these steps: 


1. 
2. 


Transfer and unpack installation files. 
Use the Install macro to install the IT. 
Install the Setup Tool. 


(Optional) Install Setup Tool Event Management System (EMS) Templates. 


Transfer and Unpack Installation Files 


You access files on the installation media for the Implementation Toolset (IT) and move 
them to the location for the installation. 


Follow these steps: 


1. 


Access the files on the installation media and use a file transport utility, such as FTP, 
to transfer the NSKIT archive file and the UNPACKIT macro to the location for IT 
installation on NonStop. Ensure that you transfer the NSKIT file in binary mode and 
the UNPACKIT file in ASCII mode. 


Log on to the NonStop server and change the volume and subvolume to the 
location where you transferred the contents of the installation media. 
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Install Implementation Toolset Using the INSTALL Macro 


Enter the following command to expand the packed file at the TACL prompt: 
run unpackit 


UNPACKIT prompts you to enter Y to continue running UNPACKIT, or enter X to exit. 
If you continue, it prompts you to accept a default location or specify the volume 
and subvolume to use to unpack the NSKIT file. 


Press Enter to unpack files to the default S<vo/>.<subvol> location, or specify 
another volume and subvolume to use. 


The script displays a message stating unpacking is complete and lists the default file 
security and userid/username for installation files. 


Respond to the prompts that display for viewing and changing or accepting the 
default file security and userid/username for installation files: 


m  Toacceptthe default file security for read, write, execute, and purge access to 
files installed, press Enter. 


m  Tospecify different file security, type Y and type the values for the file security. 
Use the format in the prompt. 


m The NonStop user ID used to log in displays as the default for file ownership. To 
accept the default user ID displayed, press Enter. 


m  Toassign ownership of the IT files to a different NonStop userid/username, 
enter Y. Type the user ID and User Name in the format that is shown and press 
Enter. 


Install Implementation Toolset Using the INSTALL Macro 


Note: If possible, stop all applications on the volume and subvolume where you will 
install the Implementation Toolset before running the INSTALL macro. 


Follow these steps: 


1. 


Run the INSTALL macro by entering the following command: 
run install 


After a brief introduction to the install procedure, the macro prompts you to specify 
the volume and subvolume for the IT. 


Press Enter to accept the default location, the current $«vol».«subvol». To specify 
another location, enter a volume and subvolume at the following prompt: 


Implementation Toolset DSV location ($VOL.SUBVOL) : 


The INSTALL macro prompts for the location of the Codepage Translation Tables 
that Distributed Processing Server applications use. The files are delivered in a 
packed file that is expanded as part of the installation. 


60 Distributed Systems Installation Guide 


Install Implementation Toolset Using the INSTALL Macro 


Press Enter to accept the default location, $<vol>. TRANSLAT where S<vol> is the 
current volume. To select another location, enter a volume and subvolume at the 
following prompt: 


Location of the CodePage Translation Tables ($VOL.SUBVOL) : 


Select the customization file, TACLCSTM or TACLLOCL, to update with the call to 
MAKEHOME. Enter 1 to update your TACLCSTM file, or enter 2 to update the 
TACLLOCL customization file for all users of the NonStop server. 


Note: The added call to MAKEHOME sets the #PMSEARCHLIST environment 
variable. 


After you confirm the selections, the installation proceeds to set the TACLCSTM or 
TACLLOCL file and to install the translation tables. This may take a few minutes due 
to the expansion of the packed file containing the Codepage Translation Tables. 
When it finishes, it continues prompting for site-specific parameters. 


Note: Entering no or N to the prompts will not prevent you from using the Setup 
Tool to install CA Gen applications on NonStop. 


The INSTALL macro displays the following prompts: 
Do you want to Configure your Site's Pathway Parameters (Y | N}? 
Do you want to Configure your Site's Compiler Parameters (Y | N}? 


(Optional) Specify to configure the site Pathway parameters and the Compiler 
parameters. When you enter Y to update the parameters, the INSTALL macro 
displays the following options: 


Default Pathway configuration: 

m L-List Configuration 

m C-Change Configuration 

m R-Return, finished configuring Pathway parameters 


Changes to the default Pathway parameters are saved in a file that is named 
PWYCNFG in the Implementation Toolset DSV location. 


Configure Compiler parameters: 

m L- List current configuration 

m C-Change current configuration 

m R-Return, finished configuring Compiler parameters 


Changes to the default Compiler parameters are saved in a file that is named 
OPTCNFG in the Implementation Toolset DSV location. 


Enter Lto list the current configuration parameters. After reviewing the 
configuration, enter C to change the parameters. After changing the parameters, 
enter R to continue the installation. 
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Install the Setup Tool 


Install the Setup Tool 


Selecting the Setup Tool installation option completes the Implementation Toolset (IT) 
installation on NonStop. 


Follow these steps: 


1. 


Enter Y to seelct the Setup Tool installation option. 

The INSTALL macro lists locations for the components that comprise the Setup Tool. 
Accept the defaults or specify different locations to use for Setup Tool installation: 
m Base: $«vol».SETUP (default) 

m SQL Catalog: $«vol».SETUP (default) 

m Database: $«vol».SETUPT (default) 

m  Executables: $«vol».SETUPX (default) 

Enter Y to accept the defaults or N to specify different locations. 


When you enter N, INSTALL prompts for a different location. After entering the 
locations, enter Y to continue. The Setup Tool Install Menu opens. 


Select Setup Tool Installation Options 


The Setup Tool Install Menu lists options to select the installation steps. 


Follow these steps: 


1. 


Type the number or letter of an option to install the Setup Tool and its Pathway 
environment. The Setup Tool Install Menu lists the following options: 


1 = (step 1) create SETUP TOOL Pathway environment 
2 = (step 2) create SETUP TOOL Database 
3 = (step 3) create SETUP TOOL programs 


Important! If you select Step 2 to create the Setup Tool database, select Step 3 to 
create the Setup Tool programs. Using a newly installed database for the Setup Tool 
with previously installed and configured tool programs can result in unpredictable 
operation. A complete Setup Tool requires you to perform all three steps that are 
listed for a new installation. 


Or, type A to perform All Steps 1, 2, & 3 


m When installing the Setup Tool for the first time, use A to complete all steps in 
order. 
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Install the Setup Tool 


To partially reinstall the Setup Tool, use one of the following methods to 
overlay a previous installation: 


m Select Step 1, then Step 3, and then enter E to exit. These steps replace the 
existing Setup Tool Pathway environment and Setup Tool programs, 
leaving the previously installed database intact, and preserving the target 
database information, including the history of every installation. 


m Select Step 1 to install the Pathway environment, then enter E to exit. 
These steps replace the existing Pathway environment and preserve the 
database that is previously installed for the Setup Tool. 


Important! If you are reinstalling the Setup Tool, run the SETSTOP command before 
reinstalling to ensure its Pathmon process is stopped. 


(step 1): create the SETUP TOOL Pathway environment requires the following 
information. For each prompt, press Enter to accept the default value, or specify a 
new value at the prompt: 


Pathmon process name for the Setup Tool 
Default: SSET 

Home Terminal name 

Default: SZHOME 

Log device 

Default name: SO 

PATHTCP2 location for the Setup Tool 
Default: SSYSTEM.SYSTEM 

Maximum number of installations 
Default: 4 

Maximum number of simultaneous compilations 


Default: 5 


Note: We recommend that you assign a unique Pathmon process name for the 
Setup Tool. 


INSTALL copies the SSYSTEM.SYSTEM.PATHTCP2 file to a location designated for the 
Setup Tool to use. The security vector for this file must allow Implementation 
Toolset users read access to the file. 


Selecting any option other than A returns you to the Setup Tool Install Menu when the 
installation finishes. Enter Q to exit the installation. 


The Setup Tool Install Menu also lists other options to access system resources such as 
the editor and the spooler. 


After finishing the installation procedure, enter Q to exit the install macro. 
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Install Setup Tool Event Manadement System Templates 


Install Setup Tool Event Manadement System Templates 


The Setup Tool includes a set of Event Management System (EMS) templates that 
enhance logging. You can optionally incorporate the EMS templates into the NonStop 
operating system EMS templates. 


The INSTTMPL macro uses these NonStop utilties to automate incorporating the Setup 

Tool EMS template updates: 

m  NonStop DSM TEMPLI utility for merging the EMS templates (TNITNRES) 

m NonStop SCF utility for making the operating system use the newly merged resident 
and non-resident EMS template files 


Ensure that you successfully execute the INSTALL macro before you run INSTTMPL. 


Installing the Setup Tool's EMS templates is optional and does not prevent using the 
Setup Tool and the IT. 


Note: For more information about merging and installing EMS templates, see the HP 
documentation. 
Follow these steps: 


1. Logon asSUPER.SUPER to run the INSTTMPL macro to incorporate the EMS 
templates for the Setup Tool into your system EMS templates. 


A prompt requests confirmation of the location for Setup Tool EMS template files. 
2. Accept the default location for the Setup Tool EMS templates. 


The macro updates the system configuration and the NonStop system uses the 
updated template files. 


Installing Support for SQL/MX 


With CA Gen 8.5, support has been added for SQL/MX. To support SQL/MX, an 
additional set of files need to be installed. This set of files includes the Java Build Tool 
that currently is supported on Windows and a set of Unix/Linux platforms. These files 
are installed in the NonStop OSS environment. 

To install SQL/MX support on NonStop OSS, follow these steps: 

1. Transfer the tar file CAGenXX. NONSTOP.tar to your NonStop OSS environment. 
2. Untar CAGenXX.NONSTOP.tar 


3. cdtoruntime/translat under the untar'd directory and untar gxt.tar 


The untar will deliver all necessary files. 
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Uninstall the Implementation Toolset 


Uninstall the Implementation Toolset 


Perform the following steps to uninstall the Setup Tool. 


Follow these steps: 


1. Before uninstalling, back up all files, tables, and programs in the Setup Tool Base, 
Catalog, Database, and Program locations. 


2. Logonasthe owner of the Setup Tool you want to remove. 


3. Runthe SETDROP macro in the base location that is specified at install time to 
remove the Setup Tool and all files in different locations that are used during Setup 
Tool installation. 


A message indicates that the removal of the Setup Tool is complete. 
Perform the following steps to uninstall the Implementation Toolset. 


Follow these steps: 


1. Before uninstalling, back up all customized files, header files, user exits, and 
configuration files. 


2. Logonasthe owner of the IT and change to the Implementation Toolset's volume 
and subvolume. 


3. Use FUP or the purge TACL command to remove all files from the file system. 


Important! All Setup Tools that are installed through an Implementation Toolset 
become inoperable when you remove the IT because the Setup Tool relies on the IT 
to successfully build and install CA Gen applications. 


Chapter 6: Required Windows Privileges 


In Windows 7 and Windows Server 2008 environments, some CA Gen component 
activities require Administrator privileges and some only require User privileges. 
Windows 7 and Windows Server 2008 allow a user with User privileges to execute any 
generated application. 


This appendix lists component activities and the minimum privileges that are required to 
run the component and execute its features. 


Note: This appendix does not define the privileges that are required to install or 
configure Oracle, DB2, Microsoft SQL, Tuxedo, MQ Series, or other third-party software. 


Before running the Toolset, Build Tool, AEFAD, or any application that accesses DB2 and 
Windows 7 users that work with DB2 must have a user account that is also a member of 
the DB2USERS group to ensure that they have read access to local DB2 configuration or 
application data. 
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General CA Gen Activity Privilege Requirements 


General CA Gen Activity Privilege Requirements 


CA Gen general activities that require Administrator privileges are: 


Install, modify, or repair a CA Gen component 

Install a PTF 

Recompile the DDL installers 

Recompile the GUI stubs in the default installation directory 
Use MSI to install a C or CH application 

Edit files in the default installation directory, C:\Program Files\..., including: 
-  application.ini 

-  codepage.ini 

- classes\codepage.properties 

-  COMMCFG.INI 

-  commcfg.properties 

-  .netV commcfg.txt 

-  GUlEnvironmentVariables.ini 

-  P3270KEY 

Edit files in the All Users directory, including IEFGDIC.INI 

Edit COMMCFG.INI, COMMCFG.PROPERTIES, COMMCFG.TXT 
Edit or rebuild the C, Java, or CH user exits 


Build the Update API Demo in the default installation directory, C:\Program Files... 


Toolset Privilege Requirements 


No Toolset activities require Administrator privileges. 


Toolset Plug-in Privilege Requirements 


No Toolset activities require Administrator privileges. 
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Build Tool Privilege Requirements 


Build Tool Privilege Requirements 


These Build Tool activities require Administrator privileges: 
= Modify the DEFAULT profile 

m Build an application with REGEDIT = YES 

m Run BT Server as a system-started daemon 

m Edit the BT scripts 


m Edit other template files 


Daemon and Funnel Privilege Requirements 


To run the daemon and funnel as a service requires Administrator privileges. 


Diagram Trace Utility Privilege Requirements 


No Diagram Trace Utility activities require Administrator privileges. 


Client Server Encyclopedia (CSE) Privilege Requirements 


These CSE activities require Administrator privileges: 
m Run CSE Config 


m Run the CSE servers as a service 


Client Manager Privilege Requirements 


To run the Communications Bridge as a service requires Administrator privileges. No 
Client Manager activities require Administrator privileges. 


Communications Bridge Privilege Requirements 


To run the Communications Bridge as a service requires Administrator privileges. 
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Restrictions 


Chapter 7: Using Multiple Release CA Gen 
Features on the Same Windows System 


Restrictions 


You can install and run some CA Gen Release 8.5 features on a Windows system that has 
CA Gen Release 8 features installed. This appendix defines the level of support and 
restrictions for using features from different releases on the same computer. 


Important! CA Gen Release 8.5 only supports installing CA Gen Release 8.5 features on a 
system after installing CA Gen Release 8. Install each release in a separate installation 
directory. Installing CA Gen Release 8 features on a system after installing CA Gen 
Release 8.5 is undefined and not supported. 


The following list defines the CA Gen Release 8.5 support and restrictions for 
components and component features when running them simultaneously with their CA 
Gen Release 8 counterparts. 


Block Mode C Applications 


Supported. Block Mode C applications link with version-specific DLLs accessible 
through the PATH environment variable. 


Build Tool 


Supported. The Build Tool utilizes variables %GEN80% and %GEN85% which 
controls linking with correct version of DLLs. 


C GUI Applications 


Supported. C GUI applications link with version-specific DLLs accessible through the 
PATH environment variable. 


C Proxy Client Applications 


Supported. The application links with version-specific DLLs accessible through the 
PATH environment variable. 


CServer Applications 


Supported. C server applications link with version-specific DLLs accessible through 
the PATH environment variable. 


Cit Applications 


Supported under IIS and Component Services. The application uses versioned 
assemblies. 
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Restrictions 


CFB Converter Services to Enterprise Java Beans 
Not supported. 
Client Manager 


CA Gen Release 8.5 does not support running the CA Gen Release 8 and CA Gen 
Release 8.5 Client Manager simultaneously and only supports executing one Client 
Manager. Attempting to run two client managers returns focus to the executing 
Client Manager. 


CA Gen Release 8 generated clients can use the CA Gen Release 8.5 Client Manager. 
Client Server Encyclopedia Clients 
Not supported. 


Note: We currently do not support running CA Gen Release 8 and CA Gen Release 
8.5 versions of the CSE clients on the same workstation. However, you can use 
either CA Gen Release 8 clients or CA Gen Release 8.5 clients to download both 
Release 8 and Release 8.5 models. Because only Release 8 clients can access both 
Release 8 and Release 8.5 CSE servers, it may be preferable to use Release 8 clients. 


Client Server Encyclopedia Servers 
Not supported. 
COM Proxy Client Applications 


Supported. The application is linked with version-specific DLLs accessible through 
the PATH environment variable. 


Communication Bridge 
Supported. 

Daemon and Funnel 
Not supported. 

Diagram Trace Utility 
Not supported. 


Note: We currently do not support running CA Gen Release 8 and CA Gen Release 
8.5 versions of the Diagram Trace Utility on the same workstation. Since the CA Gen 
Release 8.5 Diagram Trace Utility can be used to debug both CA Gen Release 8 and 
CA Gen Release 8.5 applications, use the CA Gen Release 8.5 Diagram Trace Utility 
when debugging Release 8 or Release 8.5 applications. 


EJB Server Applications 


Supported. The application uses version-specific classes. 
Encyclopedia Update API 


Not supported. 
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Restrictions 


Java Proxy Client Applications 

Supported. The application uses version-specific classes. 
.NET Client Applications 

Supported. The application uses versioned assemblies. 
.NET Proxy Client Applications 

Supported. The application uses version-specific classes. 
Toolset 


Supported. Simultaneous execution of the CA Gen Release 8.5 and CA Gen Release 
8 toolsets is supported. 


Note: The CA Gen Release 8 Toolset invokes the CA Gen Release 8.5 Client Server 
Encyclopedia (CSE) client when uploading or downloading to the CSE. 


Toolset Plug-ins 


CA Gen Release 8.5 does not support simultaneous execution of CA Gen Release 8.5 
and CA Gen Release 8 toolsets when running toolset plug-ins. 


Web Generation (Java) Client Applications 
Supported. The application uses version-specific classes. 
Workstation Update API 


Not supported. 
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